home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1998 March / Macworld (1998-03) (Disk 1).dmg / Shareware World / Info / For Developers / GhostScript 5.10 / MacGS-510 / doc / README < prev    next >
Text File  |  1997-11-11  |  7KB  |  188 lines
  1.    Copyright (C) 1989, 1996 Aladdin Enterprises.  All rights reserved.
  2.   
  3.   This file is part of Aladdin Ghostscript.
  4.   
  5.   Aladdin Ghostscript is distributed with NO WARRANTY OF ANY KIND.  No author
  6.   or distributor accepts any responsibility for the consequences of using it,
  7.   or for whether it serves any particular purpose or works at all, unless he
  8.   or she says so in writing.  Refer to the Aladdin Ghostscript Free Public
  9.   License (the "License") for full details.
  10.   
  11.   Every copy of Aladdin Ghostscript must include a copy of the License,
  12.   normally in a plain ASCII text file named PUBLIC.  The License grants you
  13.   the right to copy, modify and redistribute Aladdin Ghostscript, but only
  14.   under certain conditions described in the License.  Among other things, the
  15.   License requires that the copyright notice and this notice be preserved on
  16.   all copies.
  17.  
  18. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  19.  
  20. ****************************************************
  21. * This file describes version 5.10 of Ghostscript. *
  22. ****************************************************
  23.  
  24. If this is your first contact with Ghostscript, we suggest you read the file
  25. new-user.txt before continuing with this README file.  new-user.txt gives an
  26. overview of:
  27.  
  28.     - what Ghostscript does (PostScript and PDF previewing, conversion,
  29.     and printing);
  30.  
  31.     - what its licensing terms are (free for ordinary use);
  32.  
  33.     - what platforms it runs on (every platform you're likely to be
  34.     interested in);
  35.  
  36.     - where to find some useful programs that enhance Ghostscript (like
  37.     user-friendly previewers for Unix, VMS, MS Windows, MS-DOS, and
  38.     Macintosh).
  39.  
  40.     - what to do if you have problems (the "If you need help" section).
  41.  
  42. The rest of this README file is a road map to the documentation files that
  43. are part of the fileset.  If you are a new user, we suggest you look through
  44. it now.  After that, we recommend you read install.txt, which tells you how
  45. to install Ghostscript, and make.txt, which tells you how to compile
  46. Ghostscript from source code (which is required before installation on Unix
  47. and VMS systems).
  48.  
  49. ********
  50. ******** Documentation overview ********
  51. ********
  52.  
  53. There is a Ghostscript World Wide Web home page at 
  54.     http://www.cs.wisc.edu/~ghost/index.html
  55.  
  56. All the file names mentioned in the documentation, except for README and
  57. NEWS, are in lower case, which is the usual convention for Unix systems.  On
  58. MS-DOS systems, all file names are actually upper-case.
  59.  
  60. What should I read if I'm a new user?
  61. -------------------------------------
  62.  
  63. If you are a new user of Ghostscript, you should start by reading:
  64.  
  65. > new-user.txt - information specifically for new users.
  66.  
  67. Then read as many of the following as seem relevant:
  68.  
  69. > install.txt - information about how install Ghostscript.
  70.  
  71. > use.txt - information about to use Ghostscript.  Some of this information
  72. is also contained in gs.1 - a `man' page for Ghostscript.
  73.  
  74. > The catalog at the beginning of devs.mak, which lists all the devices for
  75. which Ghostscript is able to produce output (although if you got Ghostscript
  76. in binary form, it will only include a subset of these devices).
  77.  
  78. > devices.txt - more detailed information about some specific devices that
  79. Ghostscript knows about.
  80.  
  81. > ps2epsi.txt, unix-lpr.txt - more detailed information about some of
  82. the shell scripts and batch files distributed with Ghostscript.
  83.  
  84. > bug-form.txt - a form to use for reporting problems (but remember that
  85. Ghostscript comes with NO WARRANTY and NO SUPPORT).
  86.  
  87. If you have Aladdin Ghostscript, as opposed to the GNU Ghostscript releases
  88. distributed by the Free Software Foundation, you should read (or at least
  89. skim through):
  90.  
  91. > public.txt - additional information about Aladdin Ghostscript releases
  92. that is not relevant to GNU Ghostscript releases.
  93.  
  94. If you are going to compile Ghostscript, rather than just use an executable
  95. you got from somewhere, you should read:
  96.  
  97. > make.txt - how to compile and link Ghostscript.  (You should also read
  98. install.txt in this case.)
  99.  
  100. If you run into any questions, or if you are going to be using Ghostscript
  101. extensively, you should at least skim, and probably eventually read:
  102.  
  103. > fonts.txt - information about the fonts distributed with
  104. Ghostscript, including how to add or replace fonts.
  105.  
  106. > language.txt - A description of the Ghostscript language, and its
  107. differences from the documented PostScript language.
  108.  
  109. > psfiles.txt - information about the .ps files distributed with
  110. Ghostscript (other than fonts).
  111.  
  112. There is also a FAQ (Frequently Asked Questions) file available on the
  113. Internet.  See "If you need help" in new-user.txt for the location.
  114.  
  115. What should I read if I'm not a new user?
  116. -----------------------------------------
  117.  
  118. When you receive a new release of Ghostscript, you should start by reading:
  119.  
  120. > README - this file.
  121.  
  122. > current.txt - information about problems, and major changes and new
  123. features in the current release.
  124.  
  125. If you have used a previous release of Ghostscript, you probably should also
  126. read any more recent sections of:
  127.  
  128. > NEWS - a complete, detailed history of changes in the most recent
  129. Ghostscript releases.
  130.  
  131. What if I'm a developer?
  132. ------------------------
  133.  
  134. If you are going to be writing a new driver for Ghostscript, you
  135. should read:
  136.  
  137. > drivers.txt - the interface between Ghostscript and device drivers.
  138.  
  139. > xfonts.txt - the interface between Ghostscript and platform-supplied
  140. fonts.  (Read drivers.txt first.)
  141.  
  142. If you are considering distributing Ghostscript (either Aladdin or GNU
  143. versions) in conjunction with a commercial product, you should read the
  144. PUBLIC license carefully, and you should also read:
  145.  
  146. > commprod.txt - additional clarification of the circumstances under which
  147. Ghostscript can be distributed with a commercial product.
  148.  
  149. If you intend to use Ghostscript in the form of a DLL under OS/2 or
  150. Microsoft Windows, you should read:
  151.  
  152. > dll.txt - documentation on Ghostscript as a DLL.
  153.  
  154. If you intend to use Ghostscript as part of another program and not
  155. as a DLL, rather than as a self-contained executable application, you
  156. should start by reading either (if you will be using Ghostscript as a
  157. callable PostScript language interpreter):
  158.  
  159. > imain.h - the documented API for Ghostscript not as a DLL.
  160.  
  161. or (if you are going to use just the Ghostscript graphics library):
  162.  
  163. > lib.txt - information about the structure of and APIs for the
  164. Ghostscript library.
  165.  
  166. Other files
  167. -----------
  168.  
  169. > ps2epsi.txt - documentation for the PostScript to EPSI conversion
  170. utility.
  171.  
  172. > helpers.txt - a note of thanks to all the people who have helped with
  173. Ghostscript development.
  174.  
  175. > hershey.txt - information about the Hershey fonts, which are the
  176. basis of some of the Ghostscript fonts.
  177.  
  178. > history*.txt - a history of changes in older Ghostscript releases.
  179.  
  180. > humor.txt - a humorous comment on Ghostscript contributed by a user.
  181.  
  182. > unix-lpr.txt - information about how to integrate Ghostscript with
  183. Unix printer spooling.
  184.  
  185. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  186.  
  187. PostScript is a trademark of Adobe Systems, Incorporated.
  188.